home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr22 / inc11.zip / INC.DOC < prev   
Text File  |  1993-05-13  |  4KB  |  81 lines
  1. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
  2. *                                                                       *
  3. *   Shareware by TOM                                                    *
  4. *                                                                       *
  5. *   Goodies written in C, 80?86 assembler, FoxBase, and more.           *
  6. *                                                                       *
  7. *   Support Shareware! Register your copy of this program.              *
  8. *                                                                       *
  9. *   Register by mail to:                                                *
  10. *                         Shareware by Tom                              *
  11. *                         2371 N. 59th Street                           *
  12. *                         Milwaukee, WI 53210-2215                      *
  13. *                                                                       *
  14. *   Questions? Contact me by mail, or via Exec-PC bbs, 414-789-4210     *
  15. *   Exec-PC has MNP lines and various 9600 baud lines.                  *
  16. *   My username on EXEC is TOM PETERS.                                  *
  17. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
  18. *                              In brief:                                *
  19. *                                                                       *
  20. * Program Name: INC                   Written in: ASM                   *
  21. *                                                                       *
  22. * Registration Fee: $10                                                 *
  23. *                                                                       *
  24. * Summary of function: Creates, if needed, INC.DAT and increments a     *
  25. * count contained in INC.DAT each time it is run, also reports the      *
  26. * count.                                                                *
  27. *                                                                       *
  28. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  29.  
  30. INC: Increment and report count.
  31.  
  32. INC is normally used to batch files to count the number of passes of some 
  33. set of functions. Example: Run DT (disk test) and count the number of 
  34. passes:
  35.  
  36. ECHO OFF
  37. REM CLEAR THE COUNT
  38. INC /C
  39. :AGAIN
  40. INC
  41. DT /B /M
  42. GOTO AGAIN
  43.  
  44. Command line options:
  45.  
  46. Current options include: /C /R /Q /H. Command line option letters can be 
  47. preceded by /, - or no switch character at all. They can be in any order. 
  48. The /H option (Help) and the /C option both cause INC to perform their 
  49. respective functions and NOT increment the count. If the /H option is seen 
  50. first on the command line, no other functions are performed. If the /C option 
  51. is first, no other options are performed. 
  52.  
  53. /H Display help text.
  54.  
  55. /C Create a new, empty count file
  56.  
  57. /Q report only the count, no banner
  58.  
  59. /R report the count but do NOT increment it
  60.  
  61. Notes:
  62.  
  63. INC reports the count, and THEN increments it. If you run the program
  64. and it reports that the count is 5, and then examine the INC.DAT file,
  65. you will find that it contains the value of 6 in the first bytes.
  66.  
  67. The highest value INC.DAT can contain is 65535, because a two-byte area
  68. (low byte first) is used to store it. If the count is incremented beyond
  69. this value, it will simply wrap around to zero.
  70.  
  71. DOS EXIT CODES:
  72.  
  73. 0  Whatever function (/C, /R) was selected was successful
  74. 2  The file could not be opened, and the reason was NOT that it didn't exist
  75. 3  The file was opened ok, but could not be read
  76.  
  77. If the file open for the counter file INC.DAT fails because the file does 
  78. not exist, INC just creates a new, empty one. INC.DAT must be in the 
  79. current directory.
  80.  
  81.